home *** CD-ROM | disk | FTP | other *** search
/ Amiga News 95 / Amiga News 95.iso / dpat / dpat13 / documentation / dp managing.english next >
Text File  |  1992-09-16  |  47KB  |  1,062 lines

  1.  
  2.  
  3.                         Documentation of DP Managing
  4.                         Copyright 1992  David Scrève
  5.                         ---------------------------
  6.                            --------------------
  7.  
  8.  
  9. Document :
  10.    Author : David Scrève
  11.    Name : DP Managing.doc
  12.    Software name : DP Managing
  13.    Release : 2.21
  14.    Revision : 6.51
  15.    Date : 16 Septembre 1992
  16.    Size : 46536 bytes
  17.  
  18.    For any suggestion, complain or to obtain your user code contact me to
  19.    the following address :
  20.                M. Scrève David
  21.                DP Managing Support
  22.                4, rue Gustave Flaubert
  23.                59115 Leers
  24.                FRANCE
  25.  
  26.    Tèl : 20.75.52.73 in province.
  27.  
  28.    In order to obtain an user code, send me a lettre where you present
  29.    you to me and you explain what you would like to do with DP Managing 2.21.
  30.  
  31.  
  32.                                     Summary
  33.                                     -------
  34.  
  35.  
  36.    Content                                                     Line number
  37.    -------                                                     -----------
  38.  
  39.        Introduction..................................................0096
  40.        Hardware requirement..........................................0137
  41.        Installation..................................................0153
  42.        User Documentation............................................0166
  43.            I - General concept of DP Managing 2.21...................0169
  44.            II - Running DP Managing..................................0188
  45.            III - Menus Items.........................................0268
  46.                A - Menu Project.-....................................0276
  47.                    1 - Save the catalogue  : Amiga + C...............0281
  48.                    2 - Maintain : Amiga + M..........................0296
  49.                    3 - About... : Amiga + A..........................0309
  50.                    4 - Quit : Amiga + Q..............................0317
  51.                B - Menu Program......................................0326
  52.                    1 - Search : Amiga + J............................0332
  53.                C - Menu Export.......................................0343
  54.                    1 - News : Amiga + D..............................0364
  55.                    2 - All : Amiga + T...............................0370
  56.                    3 - Correspondances Code-categorie : Amiga + R....0376
  57.                D - Menu Print........................................0387
  58.                    1 - News : Amiga + N..............................0392
  59.                    2 - All - Amiga + U...............................0400
  60.                    3 - Statistics : Amiga + I........................0409
  61.                    4 - Correpondances code-categorie : Amiga + G.....0417
  62.                    5 - Some categories : Amiga + K...................0427
  63.                E - Menu Modules......................................0435
  64.                    1 - Single Consultation : Amiga + O...............0438
  65.                    2 - Borrow Software : Amiga + E...................0444
  66.                    3 - Add programs : Amiga + P......................0452
  67.                    4 - Statistics : Amiga +S.........................0476
  68.                F - Menu Language.....................................0485
  69.                    1 - Francais......................................0492
  70.                    2 - English.......................................0497
  71.            IV - description of the modules...........................0504
  72.                A - Maintenance.......................................0508
  73.                    1 - ERASE THE CATEGORIE...........................0522
  74.                    2 - CREATE A CATEGORIE............................0531
  75.                    3 - ERASE A MEMBER................................0538
  76.                    4 - ADD A MEMBER..................................0549
  77.                    5 - PERFORM NEWS TO OLD...........................0557
  78.                    6 - MOVE TO OTHER CATEGORIE.......................0565
  79.                    7 - ERASE THE PROGRAM.............................0572
  80.                    8 - ADD A DISK....................................0579
  81.                    9 - ERASE A DISK..................................0597
  82.                    10 - MODIFY THE PROGRAM...........................0606
  83.                    11 - UPDATE FROM A FILE...........................0615
  84.                B - Single Consultation...............................0625
  85.                C - Borrowings........................................0647
  86.                D - Add programs......................................0725
  87.                E - Statistics........................................0776
  88.        Conclusion....................................................0799
  89.        DP Managing History...........................................0814
  90.        Futur changes.................................................0953
  91.        Bug report....................................................0974
  92.        Greetings and Copyright.......................................1024
  93.  
  94.    ----------------------------------------------------------------------------
  95.  
  96.    Introduction
  97.    ------------
  98.      DP Managing was created in order to group in One software all the tools
  99.    required to manage a library of Public Domain Software.
  100.    The complete package contain the following files on One disk :
  101.  
  102.   - Two files which contain the documentation in frecn and in english :
  103.     DP Managing.francais and DP Managing.english
  104.   - The complete C sources compressed with lha program
  105.   - The binary files for GadtoolsBox 1.0 of the interface user design,
  106.     compressed with lha program.
  107.   - Two versions of DP Managing 2.21 : for 68000 and for 68030/68882
  108.   - The Two shared library Powerpacker.library and reqtools.library
  109.   - The CLI Command XICOn which is freely distributable
  110.   - The Public Domain software LHA to compact files
  111.   - Two UpDate Files which is new for release 2.21 : it's for the users of
  112.     an earlier release 2.xx : 2.21 UpDate.english and 2.21 UpDate.francais.
  113.   - A text file in french that explain how to use the 2.04 interface user and
  114.     the requesters from reqtools.library : UserStyle.doc.
  115.   - Two install scripts in french and in english
  116.  
  117.      DP Managing is freely distributable if it's for an non commercial goal.
  118.   The software can't be distributed in another package as describe below and
  119.   No file I have created is allowed to be distributed separately except
  120.   UserStyle.doc and UserStyle.english which should be distributed in many
  121.   packages.
  122.      For more details about distribution, please read the doc file in french
  123.    which is more valuable because my english is very bad.
  124.  
  125.      There is too another program named DP Managing UGC (User Code Generator)
  126.    which can generate new User codes. This software is not Freely distributable
  127.    and is not public Domain. I'm the only person who is allowed to have and
  128.    use it.
  129.      The C Sources are just given for a goal of Documentation. Any
  130.    compilation of a part or the complete program is forbidden without my
  131.    written agreement. The use of routines described in this sources is
  132.    forbidden without my written agreement especially for a commercial use.
  133.    If you don't respect these rules you could have some problem with the
  134.    police. I hope not deceive and I'm confident in the creative Amiga
  135.    community.
  136.  
  137.    Hardware requirements
  138.    ---------------------
  139.      DP Managing 2.21 respects the Amiga "Look and Feel" style. So it needs
  140.    some hardware elements which gives many other interesting features when
  141.    you use other softwares.
  142.      DP Managing 2.21 required a complete OS 2.04 or higher. The system
  143.    software must be complete because the script installation uses some CLI
  144.    commands.
  145.      There is one version complied especially for 68030/68882 and the script
  146.    installation can detect them. This version can run with 68020 and 68881
  147.    too.
  148.      DP Managing 2.21 can be load and run from a floppy disk but if you want
  149.    to install it on another disk, you need 2 disk drives or an Hard drive.
  150.    because of the size of files which are created, Hard drive is recommended.
  151.  
  152.  
  153.    Installation
  154.    ------------
  155.      The install script is veray simple and respect the "Look and feel" of
  156.    DP Managing.
  157.      To install DP Managing 2.21 you simply have to insert the floppy disk
  158.    in drive DF0: after booting on OS 2.04. Now click once on the icon
  159.    "Installation.english". Then press Shift and maintain it when clicking
  160.    on the directory where you want to install DP Managing then on the icon
  161.    "Installation.english".
  162.    Attention, The script will created its own directory in the directory
  163.    you have selected.
  164.  
  165.  
  166.    User Documentation
  167.    ------------------
  168.  
  169.      I - General Concept of DP Managing 2.21
  170.          -----------------------------------
  171.  
  172.        DP Managing 2.x and higher is very different than earlier release
  173.    (especially release 1.23 which was recently use by Ordileers).
  174.    DP Managing 2.21 is very intuitive with his graphical interface. It tries
  175.    to use each time the exclusive specifications of the OS 2.04 when
  176.    possible : DP Managing is design for the user, not for the programmer.
  177.         For example, if you have to enter differents texts in differents
  178.    Gadgets, you can stay below your keyboard : you have just to hit the
  179.    TAB key to go to another string gadget.
  180.        The concept of DP Managing is organized around the module. A module
  181.    is a complete interface user design to solve one main problem in managing
  182.    a library of public domain softwares. Now, there are 4 modules and a
  183.    special 5th which concerns the maintenance of the database.
  184.        In This text, we will first describe the items in the menus and then
  185.    we will describe each module with more details.
  186.  
  187.  
  188.      II - Running DP Managing
  189.           -------------------
  190.  
  191.       Running DP Managing 2.21 is very simply : you have just to double click
  192.    on its icon. Warning : you can't run DP Managing from the Shell. It
  193.    need some informations in the ToolsTypes of its icon. Here is a brief
  194.    description :
  195.  
  196.  
  197.      NOUVEAUTES = name of the file which contain the news in the database.
  198.      EMPRUNTS   = name of the file which contain the borrowing in the
  199.                   database.
  200.      PROGRAMMES = name of the file which contain the programs in the database.
  201.      SPECIAL    = name of the file which contain the programs which are
  202.                   forbidden to under age people.
  203.      CATEGORIE  = name of the file which contain the differents categories
  204.                   of software. Each categorie is represented by one file.
  205.      DISQUE     = name of the file which contain the differents disks
  206.                   Each disk is represented by one file.
  207.      ADHERENTS  = Name of the directory which contain the differents members
  208.                   of the group. Eache member is represented by one file.
  209.      TEMPDIR    = Name of the directory which contain the temporary files
  210.                   for the copy during managing the commands of the members.
  211.                   This directory is usually cleared after managing these
  212.                   commands.
  213.      FIRSTDISK  = Number of the first disk which will be created when you
  214.                   start a new database.
  215.      LANGUAGE   = contain the default language used starting on DP Managing.
  216.                   Actually, must be francais for french or english for
  217.                   english. By default, the software is french.
  218.  
  219.    ATTENTION : No file is directly accessible with a text editor : they are
  220.    binary files and the format isn't so simple. No documentation will be
  221.    given about the file format except the C Sources. For another information,
  222.    contact me personnaly with a serious justification. For the children who
  223.    would borrow software which are forbidden in changing their age, I said
  224.    that calculating the age required more than 150 differents operations :
  225.    Good Luck !
  226.    Safety is at this price.
  227.  
  228.      By default, the below files are created during the first use and
  229.    the drawers are created by the script installation. Frequently, the
  230.    software doesn't start because of a bad description of the configuration
  231.    in the ToolsTypes.
  232.      The following lines describes the default configuration, after
  233.    execution of the installation :
  234.  
  235.        NOUVEAUTES = fich_nouveautes
  236.        EMPRUNTS  = fich_emprunts
  237.        PROGRAMMES = fich_programmes
  238.        SPECIAL = fich_special
  239.        CATEGORIES = categorie
  240.        DISQUES = disque
  241.        ADHERENTS = adherent
  242.        TEMPDIR = tempdir
  243.        FIRSTDISK = 201
  244.        LANGUAGE = FRANCAIS
  245.  
  246.    ATTENTION :
  247.    ---------
  248.      If you destroy or modify manually one of these files, the database
  249.      will be corrupted and maybe destroy.
  250.  
  251.      If you want to change the icon, the type of it must be PROJECT. For
  252.    more information about it, please consult the Documentation of IconEd.
  253.  
  254.      When you have double-clicked on the icon, you must enter your name
  255.   with the corrects caracters then press [RETURN]. Then you must enter your
  256.   user code if you have one.
  257.   When your name and you code is enter, you have 2 chances to correct them.
  258.   If you have made too many error, you will go too in DP Managing 2.21. But
  259.   you will be in the Demo version in which you can't add new programs.
  260.      If you havn't got any user code, you can just close the window to go
  261.   to the demo version without enter any code or name.
  262.  
  263.      You will be welcomed by DP Managing and the software will indicate
  264.   the state of your system. Then you can hit the [RETURN] key or click in
  265.   the gadget to start working.
  266.  
  267.  
  268.      III - Menus Items
  269.            -----------
  270.  
  271.        DP Managing 2.21 has just 6 menus without any submenus because
  272.    I think that gadgets are more intuitives and faster than menus : the
  273.    hot keys are visually shown and we haven't to learn them. Concequently,
  274.    te program required OS 2.04.
  275.  
  276.        A - Menu Project
  277.            ------------
  278.  
  279.          This menu gorups the general functions as save, about, etc...
  280.  
  281.          1 - Save the Catalogue : Amiga + C
  282.              -------------------------------
  283.  
  284.            This option allow to save the catalogue of software as a text
  285.    file classified by categorie. The configuration required by each software
  286.    is not written to have a text which has only 80 rows and also stay
  287.    visuable by program such muchmore.
  288.  
  289.            When you select this option, a FileRequester will appear to choose
  290.    you filename to save. If you select an existing file, DP Managing will
  291.    request you to confirm erasing it.
  292.    For the use of the FileRequester, please consult your OS 2.04 documentation
  293.    or the book User Interface Style Guide edited by Addison Wesley.
  294.  
  295.  
  296.          2 - Maintenance : Amiga + M
  297.              -----------------------
  298.  
  299.            This option allow you to access to the functions of maintenance
  300.    the database. Before using this module, I recommended to make a Backup
  301.    of your files in the database.
  302.  
  303.            When you select this option, the window change and you can see
  304.    other Gadgets. But the menus are always accessibles and are the same
  305.    as before. We will give more details about this module in the following
  306.    part concerning the differents modules.
  307.  
  308.  
  309.          3 - About... : Amiga + A
  310.              --------------------
  311.  
  312.            This option allows you to obtain informations about DP Managing
  313.    and its authors. This options will be useful if you want to update your
  314.    software or if you are a lucky person who belongs to developement team.
  315.  
  316.  
  317.          4 - Quit : Amiga + Q
  318.              ----------------
  319.  
  320.            This option allow you to quit DP Managing and free 100 Kilo-Bytes
  321.   of memory. To Quit DP Managing you can close the window too.
  322.   Before quiting, DP Managing ask you to confirm your decision.
  323.  
  324.  
  325.  
  326.        B - Menu Program
  327.            ------------
  328.  
  329.            This menu give you functions to perform actions on One program
  330.    in the database. Now, there is only one option.
  331.  
  332.          1 - Search : Amiga + J
  333.              ------------------
  334.  
  335.              This option allow you to search a program in the complete
  336.    database. To perform this action, a requester will open : you will have
  337.    to give the elements you know : name, categorie, disk. If you confirm,
  338.    DP Managing will search this program in the database and will give you
  339.    the name, the categorie and the disk of the program if it has found it.
  340.    If it hasn't found the program, DP managing will say it to you.
  341.  
  342.  
  343.        C - Menu Export
  344.            -----------
  345.  
  346.          This menu gives you functions to export the database into another
  347.   file format. This format was first created for the Group Ordileers which
  348.   use it in his server Minitel (french national terminals network). For
  349.   more informations about it, you can display the file generated with a
  350.   texte reader or contact Ordileers to :
  351.  
  352.                           Ordileers
  353.                           9 bis rue du général de Gaulle
  354.                           59115 Leers
  355.                           FRANCE
  356.  
  357.          You can call them on their server from monday to friday at the
  358.    following number : 20.82.95.36  in France.
  359.    For any consultation, you need a Minitel.
  360.    During the week end, you will have to talk french to a person and not
  361.    to a server : Then, the minitel is not required.
  362.  
  363.  
  364.          1 - News : Amiga + D
  365.              ----------------
  366.  
  367.            This option allows you to export only the news.
  368.  
  369.  
  370.          2 - Tout : Amiga + T
  371.              ----------------
  372.  
  373.            This option allows you to export a\the complete database.
  374.  
  375.  
  376.          3 - Correspondances Code-catégorie : Amiga + R
  377.              -----------------------------------------
  378.  
  379.            In the format, each categorie is represented by a 2 caracters code.
  380.            this option allows you to generate a text file where the
  381.            correspondances between the code and the categorie are easily
  382.            explain.
  383.  
  384.  
  385.  
  386.  
  387.        D - Menu Print
  388.            ----------
  389.  
  390.           This menu groups the functions to make output to the printer.
  391.  
  392.          1- News : Amiga + N
  393.             ----------------
  394.  
  395.           This option allows you to print the categories where are some
  396.    news. Before printing DP Managing will request you to confirm : to
  397.    confirm, click on gadget [OK] and to cancel, click on [CANCEL].
  398.  
  399.  
  400.          2 - All : Amiga + U
  401.              ----------------
  402.  
  403.           This option is similare to the News option. But all the database
  404.    will be printed out. Personnaly, I recommended to print out One categorie
  405.    per page. This will permit to you to easily update your catalogue in
  406.    just printing the categorie which have some news.
  407.  
  408.  
  409.          3 - Statistics : Amiga + I
  410.             ------------------------
  411.  
  412.            This option allow you to print statistical datas about the
  413.    borrowings of programs. If you need others statistical datas, send me
  414.    a letter and It will change.
  415.  
  416.  
  417.          4 - Correspondances code-catégorie : Amiga + G
  418.              ------------------------------------------
  419.  
  420.            In the format, each categorie is represented by a 2 caracters code.
  421.            this option allows you to print out a paper where the
  422.            correspondances between the code and the categorie are easily
  423.            explain.
  424.  
  425.  
  426.  
  427.          5 - Some catégories : Amiga + K
  428.              ---------------------------
  429.  
  430.            This option allow you to print some categorie and not the complete
  431.   database. A ListView will appear and you will have to choice the categorie
  432.   you want to print. To perform printing you have just to click on the [OK]
  433.   button. This sequence will go while you click on the [CANCEL] button.
  434.  
  435.        E - Menu Modules
  436.            ------------
  437.  
  438.          1 - Single Consultation : Amiga + O
  439.              -------------------------------
  440.  
  441.            This option allow you to go to the consultation module. This
  442.     is the module by default when you start DP Managing.
  443.  
  444.          2 - Borrowings : Amiga + E
  445.              ----------------------
  446.  
  447.            This option allow you to go to the module which manage the
  448.    members's Commands of programs. You have just to enter the commands
  449.    with the mouse and DP Managing will request the right disks to insert.
  450.    in the same time, it will update the statistical datas.
  451.  
  452.          3 - Adding programs : Amiga + P
  453.              ---------------------------
  454.  
  455.            This option allow you to go to the module which complete the
  456.    bank of programs and the database.
  457.    In this module, you can just add programs which are in a Single File form.
  458.    For the complete disk, you must go to the module maintenance.
  459.    I recommended you crunch ypur software with lha. The .lzh is recommended
  460.    but not needed.
  461.  
  462.    How to use LHA :
  463.    --------------
  464.  
  465.          To crunch just one file, type :
  466.              lha -2 a <filename>.lzh <filename>
  467.  
  468.          To compress a complete directory, type :
  469.              lha -r -2 a <filename>.lzh <directory name>/#?
  470.  
  471.  
  472.         I recommended you includes the icons of the directories in the
  473.         archive.
  474.  
  475.  
  476.          4 - Statistics : Amiga +S
  477.              ---------------------
  478.  
  479.            this option allow you to access to the module of statistics.
  480.    You can just see the statisticals data and there is no update function
  481.    because the update is done by the module named "adding programs".
  482.  
  483.  
  484.  
  485.         F - Menu Language
  486.             -------------
  487.  
  488.             This option is made to allow the user to change the language of
  489.     DP Managing. Actually, you have coice between french an english.
  490.  
  491.  
  492.          1 - Francais : Amiga + F
  493.              --------------------
  494.  
  495.              This option change DP managing's language into french.
  496.  
  497.          2 - English : Amiga + H
  498.              -------------------
  499.  
  500.              This option change DP managing's language into english.
  501.  
  502.  
  503.  
  504.      IV - Description of the modules
  505.           --------------------------
  506.  
  507.  
  508.       A - Maintenance
  509.           -----------
  510.  
  511.         First, you can see two big Listviews which contain, for the first,
  512.    the list of the available categories, and the list of the programs which
  513.    belong to the selected categorie, for the second. The complete will
  514.    organized around thes two gadgets which come from the GadTools.library.
  515.    below each listview you can see one string gadget which shows the
  516.    element selected. If you try to enter text in these gadget, there is no
  517.    effect.
  518.      We will new describe the functions which are accessibled by differents
  519.    buttons.
  520.  
  521.  
  522.         1 - ERASE THE CATEGORIE
  523.             -------------------
  524.  
  525.           This button permit to erase the categorie selected.
  526.     Warning : All the programs which belong to this categorie will be
  527.     erased from the database. The action will be perform after confirming
  528.     in a requester.
  529.  
  530.  
  531.         2 - CREATE A CATEGORIE
  532.             -------------------
  533.  
  534.           This button simply allow you to create a new categorie of programs.
  535.    You simply have to give its name and its code.
  536.  
  537.  
  538.         3 - ERASE A MEMBER
  539.             --------------
  540.  
  541.           This button allow you to erase a member. A list of the existing
  542.    members will appear on your screen and you will have to choose one of
  543.    them. You could cancel this action in clicking on the [CANCEL] Gadget or
  544.    not confirming the action after. Warning, this action do not erasing
  545.    the number of borrowings for each categorie in the statistical datas.
  546.    You could'nt just access to the details of the borrowings of this member.
  547.  
  548.  
  549.         4 - ADD A MEMBER
  550.             ------------
  551.  
  552.           This button allow you to create a new member in the database.
  553.    His name, surname and day of birth will be required. The day of birth
  554.    must be in the same form : dd-mm-yy
  555.  
  556.  
  557.         5 - PERFORM NEWS TO OLD
  558.             -------------------
  559.  
  560.           This button allow you to delete the quality of new in the New
  561.    programs : The new programs will change to old programs. This allow you
  562.    to enter other new programs.
  563.  
  564.  
  565.         6 - MOVE TO OTHER CATEGORIE
  566.             -----------------------
  567.  
  568.           This button allow you to move the selected program to another
  569.    categorie. You will have to select the TO categorie and to confirm the
  570.    movement.
  571.  
  572.         7 - ERASE THE PROGRAM
  573.             -----------------
  574.  
  575.           This button allow you to erase a program from the database. Warning
  576.    the number of borrowings of this programs is erased too.
  577.  
  578.  
  579.         8 - ADD A DISK
  580.             ----------
  581.  
  582.           This button allow you to add a complete disk in the database. This
  583.    function is usefule when you want add programs such Megademos which must
  584.    be distributed on a full disk. If the program is composed with more one
  585.    disk, you must add a disk for each disk.
  586.    To do this add, you need the name of the program, the configuration needed
  587.    and the comment. If this disk is forbidden for under age people, you can
  588.    select this. If you confirm this add, you will have to insert a formatted
  589.    and blank disk.
  590.    Warning : This blank disk must be DOS and not NDOS. If this disk is NDOS
  591.    or cannot be renamed, insert another blank disk : DP Managing will rename
  592.    thsi disk and give the new name to you. You will just have to write
  593.    the number of the disk on the new disk
  594.  
  595.  
  596.  
  597.         9 - ERASE A DISK
  598.             ------------
  599.  
  600.           This button is similar than ERASE A CATEGORIE. You have to choose
  601.    a disk in a listview and if you confirm, DP Managing erase all the selected
  602.    disk and the programs which belong to it. This function is useful if
  603.    you have disk with a Bad sector (cf Read/Write Error).
  604.  
  605.  
  606.         10 - MODIFY THE PROGRAM
  607.              ------------------
  608.  
  609.           This button allow you to change the configuration or the comment
  610.    attached to a program. A Requester will appear and you will just have to
  611.    modify what you want. The Empty fields will be refused by DP Managing.
  612.  
  613.  
  614.  
  615.         11 - UPDATE FROM A FILE
  616.              ------------------
  617.              This option allow you to update you statistical datas from
  618.    an external file which was generated by another computer when it have
  619.    managed some borrowings (cf Borrowings module). A FileRequester will
  620.    appear to choose the file to load and the update will be done
  621.    automatically. For more details, see the chapter about the Borrowings
  622.    module.
  623.  
  624.  
  625.       B - Single Consultation
  626.           -------------------
  627.  
  628.         This module was designed to scan the complete database in a fully
  629.    interactive way.
  630.      You can see four listes called ListViews. Under each listview you can
  631.    see a string gadget which shows what you have selected.
  632.      If you select one of the available categories, the list of programs change
  633.    with the list of the programs which belong to the selected categorie.
  634.    The second program will be automaticaly selected and the disk of this
  635.    program will be too : you can see the programs which are in the same
  636.    disk than the selected program.
  637.      This sequence could be done starting with selecting the disk and the
  638.    categorie of the program would be automaticaly selected.
  639.      You can now select one program of the two lists and the others lists
  640.    will be automaticaly updated.
  641.      Under these listview, you can read other informations about the selected
  642.    program : size in Bytes, comment, configuration needed, number of borrowings
  643.    and if the program is new or not and if it's forbidden for under age
  644.  
  645.  
  646.  
  647.       C - Borrowings
  648.           ----------
  649.  
  650.         This module will help you to manage the commands of programs from
  651.    the members.
  652.      Warning, this module creates 2 temporary files you must delete before
  653.    starting anything else in this module. Usually, they are automaticaly
  654.    deleted, but they could exist if DP Managing has already been stopped by
  655.    any problem in your system (gourou, etc...).
  656.    These 2 files are located in DP Managing's directory and are named :
  657.  
  658.            NE_PAS_TOUCHER_DOMPUB
  659.  
  660.            DpManaging_TempFile
  661.  
  662.  
  663.      If they aren't deleted, you can have many problem during managing
  664.    the commands.
  665.      I recommended too to clean the temporary directory (default name : tempdir)
  666.    Usually this directory is automaticaly cleaned. If this directory isn't
  667.    empty, the unit could be full during the managing.
  668.  
  669.      In the module, you can see 3 ListViews : One for the disks, one for the
  670.    list of the programs contained in the selected disk, and one for the list
  671.    of the members. You can't access to the menus because the menus options
  672.    could conflict with the module. The only way to change the current module
  673.    is to click on the [CANCEL] button. If you close the window, you quit
  674.    DP Managing.
  675.  
  676.      To enter a commands, execute the follwing actions, in order :
  677.  
  678.         1 - Sélect a member
  679.         2 - Sélect the disk of the first program of the command
  680.         3 - Sélect the program
  681.         4 - Click on the [CONFIRM BORROWING] button
  682.         5 - Return to the action 2 until you have enter the complete command
  683.  
  684.  
  685.      To delete a program from a command :
  686.  
  687.         1 - Sélecta member
  688.         2 - Sélect the program to delete
  689.         3 - Click on the [DELETE] button
  690.  
  691.  
  692.    You can also simply manage all the members commands in clicking on their
  693.    name. If you click on a borrowed program, you could have its size in
  694.    Bytes. The number of disks required is given too. By default, one command
  695.    need one disk.
  696.      When you have entered all the commands, you must decided how the
  697.   statistical datas will be updated. To perform this action, you have
  698.   2 buttons which allow you to update to datas on an external file or
  699.   directly in the database. If you manage the commands with only one Amiga
  700.   you should choose update the Database directly. If you manage the commands
  701.   on differents computers, it's very useful to have the statistical datas on
  702.   only one system : So you should select an update on an external file.
  703.     If you choose an external update, the module will generate an external
  704.   file which name will be given at the end of managing the commands. The
  705.   statistical data will not be directly updated. To finally update the
  706.   statistical datas on your main Amiga, you have to use the maintenance
  707.   module and the option UPDATE FROM A FILE. Then the statisticals will
  708.   be really updated. Your main Amiga contains the real statisticals
  709.   data and it must update directly the statistical data, because it is the
  710.   computer which contains the statistics.
  711.  
  712.      When you have choose your update mode, you have just to click on the
  713.    [PERFORM ALL THE COMMANDS] button. DP managing 2.21 will ask you for the
  714.    differents disks of the bank of programs it need and will copy the programs
  715.    commanded in the temporary directory.
  716.      Then, it will ask you for the members disks and manage the commands.
  717.    During this process, the gadgets are unacccessible. When this process is
  718.    ended, DP Managing returns to the Single Consultation module.
  719.  
  720.  
  721.      If you have click on the [CANCEL] button before starting managing the
  722.    borrowing, you return to the Single Consultation Module.
  723.  
  724.  
  725.       D - Add programs
  726.           ------------
  727.  
  728.         This module has been written to complete the banks of programs and
  729.    the database automatically. For that, each program MUST be in a Single
  730.    File form. I recommended you compress your software in one file. The
  731.    .lzh is recommended, but not needed, and I recommended the software
  732.    lha to compact your software. All your files must be in the same directory.
  733.      When you start this module, a FileRequester appear and ask you to choose
  734.    the directory where your new softwares are. This requester shows only
  735.    the files with the .lzh extension.
  736.  
  737.  
  738.      WARNING : This directory musn't contain other file than the new programs.
  739.                 If there are other files, these files will be add to the
  740.                 library as normal programs. You can cancel adding this file
  741.                 but it isn't recommended.
  742.                When a file has been added to the database, it's automatically
  743.                 deleted from the directory : Check if you want to delete it
  744.                 before adding this program.
  745.  
  746.  
  747.      To easily work, prepare a efficient number of blank and formatted disks
  748.    to copy the programs in the database : DP managing will ask you for them
  749.    when it will need them and will give you their number. Each disk will
  750.    be renamed by his number. Don't rename these disks if you doesn't want
  751.    to have any problem.
  752.  
  753.      When you have choose the directoyr, DP Managing will scan all the files
  754.    contained in and will ask you for differents informations about these.
  755.      First, you must enter the categorie of this new program. The list of
  756.    the categories will appear and you can choose on of them. If you want cancel
  757.    adding this program, click on the [CANCEL] button. If you want cancel all
  758.    the followings add, choose a categorie and click on the [OK] button. Then,
  759.    click on the [CANCEL ALL] button to cancel all.
  760.  
  761.       Then, if you have choosen to add this program, click on the [OK] button.
  762.    Differents gadgets appear concerning the configuration, the comment and
  763.    the fact that this software is forbidden for under age people or not. You
  764.    just have to complete these gadgets. To perform this add you just have to
  765.    click on the CONFIRM THE ADD] button. You can cancel this add or cancel
  766.    all the adds with the others buttons.
  767.  
  768.       If you confirm this add, DP Managing 2.21 will ask you for a disk in
  769.    the bank or for a new blank and formatted disk to copy the program in
  770.    the library. The FROM file will be deleted.
  771.  
  772.      This procedure will repeat until there is no program in the selected
  773.    directory. Then the program will be return to the Single Consultation
  774.    module.
  775.  
  776.       E - Statistics
  777.           ----------
  778.  
  779.         This module gives you statistical informations about the borrowings
  780.    per categorie, per member and for each programs, in an interactive way.
  781.      First, we can see 2 parts in the window :
  782.  
  783.  
  784.          In the left side : 1 column which contain 2 ListViews containing
  785.        the list of the categories and the list of the selected categorie.
  786.        We can see below each ListView the numbers of borrowings in each
  787.        categorie and for each program.
  788.  
  789.          In the right side : This side concern the informations for
  790.        each member. We can see the list of the members and on its right,
  791.        the list of the programs he has already borrowed. We can select a program,
  792.        but it's no effect now : It's for the future.
  793.        Below, we can get others informations about the surname, age and the
  794.        number of commands and the number of programs borrowed.
  795.  
  796.  
  797.  
  798.  
  799.    Conclusion
  800.    ----------
  801.  
  802.      This is the first release in English of DP Managing. I know my English
  803.    is bad, but I hope to be understand. I think I have explain all the
  804.    features of DP Managing 2.21? As you can see, DP Managing offers many
  805.    features and many will be added in the futures, as it has made in the
  806.    past since the 1.23 release. But if you want many change, you must complain
  807.    yourself to me. And don't be afraid, I like being criticizing in french,
  808.    english or german.
  809.  
  810.  
  811.    ----------------------------------------------------------------------------
  812.    ----------------------------------------------------------------------------
  813.  
  814.    Release History :
  815.  
  816.     Release 1.23 : August 1991 20th
  817.              First operationnal release of DP Managing which was not
  818.            named with this named. Written in GFA Base 3.01, it worked
  819.            only in memory with text files. The database was limited
  820.            to 1500 programs and 30 categories and only 50 programs
  821.            per categorie. This software needed 2 Meg of free RAM
  822.            and should ahve to support many bugs of GFA Basic 3.01
  823.  
  824.  
  825.     Release 2.0 (Revision 4.52) : August 1992 11th
  826.              Second release availablein the public domain : Fully
  827.            rewritten in SAS/C 5.10b and rethough for the OS 2.04.
  828.            DP Managing represents 8913 lines of C for the code,
  829.            and more than 10000 lines of intermediat code. I have
  830.            work more than 350 hours for 1,5 month. Greetings to
  831.            Franck Gédo for his help during debugging, his advices
  832.            and for correcting this text.
  833.              DP Managing is now just limited by the disk capacity
  834.            concerning the size of the database. It can now manage
  835.            the commands of the members completely (copying and updating
  836.            the statistical datas) and update the library of programs.
  837.  
  838.     Release 2.1 (Revision 5.01) : August 1992 17th
  839.              Third release, unavailable for the public, deleted from
  840.              my archives.
  841.            - Bug when computing the age of the people fixed (the age was
  842.              increase of 1 year)
  843.            - Bug when deleting a disk : the disk was effectively deleted on
  844.              the disk, but not in memory : fixed
  845.            - Change in the Text of the option "About..."
  846.            - As we expect, we can now print just some categories (last option
  847.              in the menu Print)
  848.            - The structure of the code was Release for doing easier change
  849.              in the software : The code is the same for all the releases
  850.              (demo and other)
  851.            - Bug whne printing categorie where there is no program to print : the
  852.              header is now not printed
  853.            - The area for reading is biggest in the Single Consultation
  854.              module.
  855.            - Bugs in the documentation : fixed
  856.            - The demo and the complete release are in the same executable.
  857.            - All the requesters support Hot keys with [RETURN] for OK and
  858.              [ESC] for CANCEL
  859.            - The wait pointer is now animated and  appears when it's really
  860.              needed.
  861.            - Most Gadgets supports an Hot key shown by an Underscore of
  862.              the hot letter.
  863.            - The number of disks needed for managing one commands is more
  864.              real than before.
  865.  
  866.     Release 2.11, Revision 5.21 : August 1992 21th
  867.            Third version avalible for the public. This release is more usable
  868.            than release 2.1 and has new interesting features which permit
  869.            to use DP Managing with only keyboard or only mouse with the same
  870.            possibilities :
  871.  
  872.            - Many requester appears in the DP Managing screen and not in the
  873.              Workbench Screen : I use the Reqtools.library less than before,
  874.              because it react at too many random.
  875.            - When you enter a new member, categorie or programmes, each
  876.              gadget has its own Hot key.
  877.            - When we erase a disk or a member, the text doesn't speak about
  878.              categorie : bug fixed
  879.            - When we add new programs, the place where we write is bigger
  880.            - The pointer is not animated now : the reqtools.library. This
  881.              was not correctly explain in the reqtools.library documentation
  882.            - Most of the string gadgets support an HotKey  now
  883.            - When we must select an disk or a member to delete, a requester
  884.              inform us if we haven't select anything.
  885.            - Some debug code has been deleted from the 2.1 source code.
  886.  
  887.                 Revision 5.22 : August 1992 22th :
  888.                 This revision has been distributed to few people. This
  889.            revision replaces the before which is unavailable now.
  890.  
  891.              - Now the Borrowings module support the HotKeys
  892.              - The screen title has been corrected to be the same as the other
  893.                modules.
  894.  
  895.                 Revision 5.23 : August 1992 28th
  896.                This revision replace the before.
  897.              Some has been fixed and now DP Managing give the unit of memory
  898.              to show the free memory when starting.
  899.  
  900.                 Revision 5.30 : August 1992 29th
  901.                 This revision replace the before :
  902.                 Now, the requesters appearing when we add new programs
  903.            appears only when they are needed : there are just 2 requesters
  904.            to informs us that the 2 mains actions are succesful : they
  905.            appears only when there is a problem or appears when ther is
  906.            no problem, but support HotKey in this case.
  907.  
  908.                 Revision 5.31 : September 1992 5th
  909.                 Thisrelease replace the before :
  910.                 - The routine which save the catalogue had been rewritten
  911.            for the release 2.1 and save the configuration too, which cause
  912.            that the text xas unreadable from muchmore : Bug fixed
  913.                 - The date of the last touch of each release appears now
  914.              in the option "About..."
  915.            About.
  916.                 - The summary had been corrected : the line numbers were
  917.                   false.
  918.  
  919.     Release 2.2 : Revision 6.2 : September 1992 12th
  920.                 New release of DP managing for ATACOM'92 :
  921.            - Support 2 languages : DP Managing speaks now english
  922.            - Add a new ToolsType for supporting the new features of 2
  923.              languages.
  924.            - Support NTSC monitors (not tested)
  925.            - Allow to modify the comment and the configuration of a
  926.              program.
  927.            - Can research a program in the complete database
  928.            - Documentation partially translated in English
  929.            - The files in the temporary directory are now really deleted
  930.              when all the commands has been managed
  931.            - DP Managing allow now the user to manage the commands on
  932.              different computers and to backup the statistical datas on
  933.              only one computer.
  934.  
  935.      Release 2.21 : Revision 6.5 : September 1992 14th :
  936.                 debugged Version of the revision 6.2 :
  937.            - When we change the language in the module of maintenance, the
  938.              gourou doesn't make now any meditation.
  939.            - The complete documentation is translated in english, even the
  940.              other text and the script installation.
  941.            - The English messages are not written above others gadgets in the
  942.              module statistics
  943.  
  944.                 Revision 6.51: Spetembre 1992 16th :
  945.            - The size of the programs given in the Single Consultation module
  946.              is now differents than -1 : The consultation function which
  947.              has been rewritten for release 2.2 was corrupted. This bug is
  948.              now fixed with the help from Jérôme Torchy who has found this
  949.              bug, I have solve it.
  950.  
  951.    ----------------------------------------------------------------------------
  952.  
  953.    Futur changes in the Software :
  954.  
  955.       - Add an ARexx port
  956.  
  957.       - Add many features when printing the statistical datas
  958.  
  959.       - Compression functions compatible lha included in the software
  960.  
  961.       - functions to format and copy disks included in the software, if
  962.       Commodore will give to me the include file V37+ and debugge the
  963.       Format format in the Dos.library.
  964.  
  965.       - Correct the errors and my english in the documentation, and try to
  966.       be more understanding.
  967.  
  968.       - Close the starting window
  969.  
  970.  
  971.    ----------------------------------------------------------------------------
  972.    ----------------------------------------------------------------------------
  973.  
  974.      For any information, contact me to the address written below, or for
  975.    any bug report. For the bug report, please write it as Commodore says :
  976.  
  977.        1) Hardware used
  978.           -------------
  979.  
  980.         * Type of Amiga
  981.  
  982.         * Capacity and type of memory (slow, Chip, Fast, autoconfig)
  983.  
  984.         * Custom Chip : name, revision (R3 for Denise ECS 8373), referen-
  985.         -ce, ECS or not, PAL/NTSC
  986.         * external hardware used for saving : Hard disk, floppy drive
  987.         with total capicity and free space.
  988.  
  989.         * Other hardware which can change any system vector or forbidden
  990.           thing (Freezer card, etc...)
  991.  
  992.         * Hardware extension such accelerator card.
  993.  
  994.  
  995.         2) Software Environnement
  996.            ----------------------
  997.  
  998.         * Version of your system software (Kickstart et WorkBench) written
  999.           such 3X.XXX and not 2.XX
  1000.  
  1001.         * Version of all your library in the directory libs:
  1002.  
  1003.         * Version of all your handlers and devices
  1004.  
  1005.         * Reference of all your softwares used in the same time (antivirus,
  1006.           mouse accelerator, replacing ROM in RAM 32 Bits, etc)
  1007.  
  1008.  
  1009.        3) Analysing the problem
  1010.           ---------------------
  1011.  
  1012.         * Describe the problem with many details
  1013.  
  1014.         * Describe the differents action needed to obtain this problem
  1015.  
  1016.         * Consequences created by this problème (database corrupted,
  1017.           Gourou meditation, etc...)
  1018.  
  1019.  
  1020.    ----------------------------------------------------------------------------
  1021.    ----------------------------------------------------------------------------
  1022.  
  1023.  
  1024.    All the trademark said in this text are trademark.
  1025.  
  1026.  
  1027.  Thanks to : - Jay Miner  for the Amiga
  1028.        - Bell Laboratorie for the C language
  1029.        - SAS Lattice for his C compiler
  1030.        - All the Ingenieer of Commodore-Amiga for the OS 2.04
  1031.        - Franck Gédo for the design, correcting this text and for the tests.
  1032.        - Nico François for the powerpacker.library and reqtools.library
  1033.          used in this software.
  1034.        - Ordileers for his ideas, and interesting advises.
  1035.        - Jan van den Baard for GadToolsBox 1.0 and GadToolsBox 1.3
  1036.        - Jérôme Torchy for found the bug in revision 6.5 in Single
  1037.          Consultation module.
  1038.  
  1039.    the files powerpacker.library et reqtools.library are Copyright (c) Nico
  1040.    François.
  1041.  
  1042.  
  1043.    DP Managing 1.23, DP Managing 2.0, DP Managing 2.1, DP Managing 2.11,
  1044.    DP managing 2.2 and DP Managing 2.21 are (c) 1991/1992 Scrève David
  1045.  
  1046.      DP Managing 2.21 is freely distributable, The user code simply permits
  1047.    to me to register the user and to preserve safety in their database.
  1048.      DP Managing 2.21 Must'nt be used for a commercial use.
  1049.    All types of contribution with documentation, help or money are welcomed
  1050.    to help me to give to Amiga the notoriety he should have.
  1051.  
  1052.    ****************************************************************************
  1053.    ****************************************************************************
  1054.  
  1055.    Have a FUN with DP Managing 2.21 and don't forget :
  1056.  
  1057.                               //
  1058.    *****************   Only \X/Amiga Makes It Possible  ***********************
  1059.  
  1060.  
  1061.    ****************************************************************************
  1062.    ****************************************************************************